Node / meshtastic / Meshtastic-Android / files / feature / node / src / commonTest / kotlin / org / meshtastic / feature / node / metrics / AirQualityMetricsTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.node.metrics

Tff7b72import T7ee787org.meshtastic.proto.AirQualityMetrics

Tff7b72import T7ee787org.meshtastic.proto.Telemetry

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertNull

T8b949e/**

* Unit tests for the air-quality chart's value extraction ([AirQuality.getValue]).

*

* Locks the BUG B fix: a present-and-zero reading (a PM sensor in clean air reports 0 µg/m³) must be plotted, while a

* genuinely absent field stays null so the metric is neither charted nor offered as a selectable chip. Also pins the

* assumption that a partial-sensor node (e.g. CO2 only) leaves the other fields unset/null rather than zero.

*/

Tff7b72class T56d364AirQualityMetricsTest Tb4b4b4{

Tff7b72private Tff7b72fun Td2a8fftelemetryTb4b4b4(Te6edf3aqTb4b4b4: Te6edf3AirQualityMetricsTb4b4b4) Tff7b72= Te6edf3TelemetryTb4b4b4(Te6edf3air_quality_metrics Tff7b72= Te6edf3aqTb4b4b4)

Tf0883e@Test

Tff7b72fun Td2a8ff`getValue returns present non-zero readings`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3t Tff7b72= Te6edf3telemetryTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3pm10_standard Tff7b72= T79c0ff1Tb4b4b4, Te6edf3pm25_standard Tff7b72= T79c0ff2Tb4b4b4, Te6edf3pm100_standard Tff7b72= T79c0ff3Tb4b4b4, Te6edf3co2 Tff7b72= T79c0ff8T79c0ff0T79c0ff0Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3PM1_0Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff2fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3PM2_5Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff3fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3PM10Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff8T79c0ff0T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`getValue plots a present-zero reading instead of suppressing it`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// BUG B regression: clean air reads 0 µg/m³ and must chart as 0f, not be dropped to null.

Tff7b72val Te6edf3t Tff7b72= Te6edf3telemetryTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3pm10_standard Tff7b72= T79c0ff0Tb4b4b4, Te6edf3pm25_standard Tff7b72= T79c0ff0Tb4b4b4, Te6edf3pm100_standard Tff7b72= T79c0ff0Tb4b4b4, Te6edf3co2 Tff7b72= T79c0ff0Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3PM1_0Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3PM2_5Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3PM10Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`getValue returns null for an absent field so a partial-sensor node does not chart spurious series`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// A CO2-only node leaves the PM fields unset (Wire decodes an unset optional uint32 to null).

Tff7b72val Te6edf3t Tff7b72= Te6edf3telemetryTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3co2 Tff7b72= T79c0ff4T79c0ff5T79c0ff0Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3PM1_0Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3PM2_5Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3PM10Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff4T79c0ff5T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`getValue returns null for every series when there are no air quality metrics`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3t Tff7b72= Te6edf3TelemetryTb4b4b4(Tb4b4b4)

Te6edf3AirQualityTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{

Te6edf3assertNullTb4b4b4(Tffa657itTb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4, Ta5d6ff"Tffd700${Tffa657itTb4b4b4.Te6edf3nameTffd700}Ta5d6ff should be null without air_quality_metricsTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`metricsWithData drops selected series that have no reading so the legend is not ever-present`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// Issue 5873, CO2-only node: PM2.5 is default-selected but never reported, so it must not survive into the

T8b949e// legend.

Tff7b72val Te6edf3co2Only Tff7b72= Te6edf3listOfTb4b4b4(Te6edf3sampleTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3co2 Tff7b72= T79c0ff4T79c0ff5T79c0ff0Tb4b4b4)Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4)Tb4b4b4, Te6edf3metricsWithDataTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3PM2_5Tb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4)Tb4b4b4, Te6edf3co2OnlyTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`metricsWithData keeps a series once it has any reading in the frame`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3mixed Tff7b72= Te6edf3listOfTb4b4b4(Te6edf3sampleTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3co2 Tff7b72= T79c0ff4T79c0ff5T79c0ff0Tb4b4b4)Tb4b4b4)Tb4b4b4, Te6edf3sampleTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3pm25_standard Tff7b72= T79c0ff8Tb4b4b4)Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(

Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3PM2_5Tb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4)Tb4b4b4,

Te6edf3metricsWithDataTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3PM2_5Tb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3CO2Tb4b4b4)Tb4b4b4, Te6edf3mixedTb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e// --- AQI series (issue #6381): derived from PM2.5 history, not carried by the telemetry proto ---

Tf0883e@Test

Tff7b72fun Td2a8ff`getValue for AQI comes from the sample derived value rather than the telemetry`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3t Tff7b72= Te6edf3telemetryTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Te6edf3pm25_standard Tff7b72= T79c0ff2T79c0ff5Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3tTb4b4b4)Tb4b4b4, Ta5d6ff"Ta5d6ffAQI is not a proto field, so a bare Telemetry has noneTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff7T79c0ff8fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3AirQualitySampleTb4b4b4(Te6edf3tTb4b4b4, Te6edf3aqi Tff7b72= T79c0ff7T79c0ff8Tb4b4b4)Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3AirQualitySampleTb4b4b4(Te6edf3tTb4b4b4, Te6edf3aqi Tff7b72= Tff7b72nullTb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`getValue for AQI plots a zero AQI instead of suppressing it`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// Pristine air is AQI 0 - a real value, and the same present-and-zero rule the PM series follow.

Te6edf3assertEqualsTb4b4b4(T79c0ff0fTb4b4b4, Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4.Te6edf3getValueTb4b4b4(Te6edf3AirQualitySampleTb4b4b4(Te6edf3telemetryTb4b4b4(Te6edf3AirQualityMetricsTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4, Te6edf3aqi Tff7b72= T79c0ff0Tb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`withNowCastAqi returns samples ascending by time regardless of input order`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// The list view feeds newest-first data in; the chart needs oldest-first.

Tff7b72val Te6edf3newestFirst Tff7b72= Tb4b4b4(T79c0ff3 Te6edf3downTo T79c0ff0Tb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3hourlyTelemetryTb4b4b4(Tffa657itTb4b4b4, Te6edf3pm25 Tff7b72= T79c0ff1T79c0ff0Tb4b4b4) Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(T79c0ff0Tb4b4b4, T79c0ff1Tb4b4b4, T79c0ff2Tb4b4b4, T79c0ff3Tb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3HOUR Tff7b72* Tffa657it Tb4b4b4}Tb4b4b4, Te6edf3withNowCastAqiTb4b4b4(Te6edf3newestFirstTb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3telemetryTb4b4b4.Te6edf3time Tb4b4b4}Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`withNowCastAqi leaves the earliest sample without an AQI and fills in later ones`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3samples Tff7b72= Te6edf3withNowCastAqiTb4b4b4(Tb4b4b4(T79c0ff0.Tb4b4b4.T79c0ff3Tb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3hourlyTelemetryTb4b4b4(Tffa657itTb4b4b4, Te6edf3pm25 Tff7b72= T79c0ff1T79c0ff0Tb4b4b4) Tb4b4b4}Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3samplesTb4b4b4.Te6edf3firstTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3aqiTb4b4b4, Ta5d6ff"Ta5d6ffone hour of history is below EPA's minimum-data ruleTa5d6ff"Tb4b4b4)

T8b949e// 2024 EPA table: a steady 10 µg/m³ is AQI 53 (Moderate).

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(T79c0ff5T79c0ff3Tb4b4b4, T79c0ff5T79c0ff3Tb4b4b4, T79c0ff5T79c0ff3Tb4b4b4)Tb4b4b4, Te6edf3samplesTb4b4b4.Te6edf3dropTb4b4b4(T79c0ff1Tb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3aqi Tb4b4b4}Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4)Tb4b4b4, Te6edf3metricsWithDataTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4)Tb4b4b4, Te6edf3samplesTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`withNowCastAqi gives a CO2-only node no AQI so the series is never offered`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3co2Only Tff7b72=

Tb4b4b4(T79c0ff0.Tb4b4b4.T79c0ff3Tb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3hour Tff7b72-Tff7b72> Te6edf3TelemetryTb4b4b4(Te6edf3time Tff7b72= Te6edf3HOUR Tff7b72* Te6edf3hourTb4b4b4, Te6edf3air_quality_metrics Tff7b72= Te6edf3AirQualityMetricsTb4b4b4(Te6edf3co2 Tff7b72= T79c0ff4T79c0ff5T79c0ff0Tb4b4b4)Tb4b4b4) Tb4b4b4}

Tff7b72val Te6edf3samples Tff7b72= Te6edf3withNowCastAqiTb4b4b4(Te6edf3co2OnlyTb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3samplesTb4b4b4.Te6edf3mapNotNull Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3aqi Tb4b4b4}Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3metricsWithDataTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3AirQualityTb4b4b4.Te6edf3AQITb4b4b4)Tb4b4b4, Te6edf3samplesTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`withNowCastAqi skips samples whose PM2_5 is absent without shifting the others' values`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// A CO2-only sample interleaved with PM2.5 samples must not consume an entry of the AQI series.

Tff7b72val Te6edf3telemetries Tff7b72=

Te6edf3listOfTb4b4b4(

Te6edf3hourlyTelemetryTb4b4b4(T79c0ff0Tb4b4b4, Te6edf3pm25 Tff7b72= T79c0ff1T79c0ff0Tb4b4b4)Tb4b4b4,

Te6edf3TelemetryTb4b4b4(Te6edf3time Tff7b72= Te6edf3HOURTb4b4b4, Te6edf3air_quality_metrics Tff7b72= Te6edf3AirQualityMetricsTb4b4b4(Te6edf3co2 Tff7b72= T79c0ff4T79c0ff5T79c0ff0Tb4b4b4)Tb4b4b4)Tb4b4b4,

Te6edf3hourlyTelemetryTb4b4b4(T79c0ff2Tb4b4b4, Te6edf3pm25 Tff7b72= T79c0ff1T79c0ff0Tb4b4b4)Tb4b4b4,

Te6edf3hourlyTelemetryTb4b4b4(T79c0ff3Tb4b4b4, Te6edf3pm25 Tff7b72= T79c0ff1T79c0ff0Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tff7b72val Te6edf3samples Tff7b72= Te6edf3withNowCastAqiTb4b4b4(Te6edf3telemetriesTb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3samplesTff7b72[T79c0ff1Tff7b72]Tb4b4b4.Te6edf3aqiTb4b4b4, Ta5d6ff"Ta5d6ffa sample with no PM2.5 reading gets no AQITa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff5T79c0ff3Tb4b4b4, Te6edf3samplesTff7b72[T79c0ff3Tff7b72]Tb4b4b4.Te6edf3aqiTb4b4b4)

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffhourlyTelemetryTb4b4b4(Te6edf3hoursFromStartTb4b4b4: Tffa657IntTb4b4b4, Te6edf3pm25Tb4b4b4: Tffa657IntTb4b4b4) Tff7b72=

Te6edf3TelemetryTb4b4b4(Te6edf3time Tff7b72= Te6edf3HOUR Tff7b72* Te6edf3hoursFromStartTb4b4b4, Te6edf3air_quality_metrics Tff7b72= Te6edf3AirQualityMetricsTb4b4b4(Te6edf3pm25_standard Tff7b72= Te6edf3pm25Tb4b4b4)Tb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffsampleTb4b4b4(Te6edf3aqTb4b4b4: Te6edf3AirQualityMetricsTb4b4b4, Te6edf3aqiTb4b4b4: Tffa657Int? Tff7b72= Tff7b72nullTb4b4b4) Tff7b72= Te6edf3AirQualitySampleTb4b4b4(Te6edf3telemetryTb4b4b4(Te6edf3aqTb4b4b4)Tb4b4b4, Te6edf3aqiTb4b4b4)

Tff7b72private Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72const Tff7b72val Te6edf3HOUR Tff7b72= T79c0ff3T79c0ff6T79c0ff0T79c0ff0

Tb4b4b4}

Tb4b4b4}